Oracle TimesTen In-Memory Database APIおよびSQLリファレンス・ガイド

ttRepSubscriberWait

説明

マスター・ストアまたは送信側ストアに対し、このプロシージャが呼び出された時点の書込みLSNにサブスクライバが追いつくまで待機させます。ttRepSubscriberWaitプロシージャによって、プロシージャのコール時点までにコミットされたすべての更新が、subscriberStoreNameサブスクライバに送信されていること、およびサブスクライバがサブスクライバ・データ・ストアで更新が永続的にコミットされたことを認識していることが保証されます。

waitTimeパラメータを-1に、subscriberStoreNameパラメータをNULLに設定した場合、プロシージャのコール時点までにコミットされたすべての更新がすべてのサブスクライバに送信され、更新が永続的にコミットされたことをすべてのサブスクライバが認識するまで、ttRepSubscriberWaitプロシージャは結果を返しません。

緊急レスポンスが必要な場合は、ttRepSubscriberWait関数を使用しないでください。RETURN RECEIPTサービスを使用してください。

注意: すべての書込みトランザクション・アクティビティがストアで静止された後にこのプロシージャがコールされた場合（アクティブなトランザクション、起動されているトランザクションがない状態）、すべての更新がサブスクライバで永続的にコミットされていることを示す応答をサブスクライバが送信するまでに60秒以上かかる可能性があります。

アクセス制御

アクセス制御がTimesTenのインスタンスに対して有効である場合、このプロシージャにはADMIN権限が必要です。

構文

ttRepSubscriberWait (replicationName, replicationOwner,
subscriberStoreName, subscriberHostName, waitTime)

パラメータ

ttRepSubscriberWaitには、次のパラメータがあります。


パラメータ	データ型	説明
replicationName	CHAR(30)	処理対象のレプリケーション・スキーム名です。NULLは、すべてのレプリケーション・スキームを示します。
replicationOwner	CHAR(30)	レプリケーション・スキームの所有者です。NULLは、すべてのレプリケーション・スキーム所有者を示します。
subscriberStoreName	VARCHAR(200)	状態を設定するサブスクライバのデータ・ストア名です。NULLは、subscriberHostNameホスト上のすべてのストアを示します。
subscriberHostName	VARCHAR(200)	サブスクライバのホストです。NULLは、サブスクライバのピアのすべてのホストを示します。
waitTime	INTEGER	指定したサブスクライバを待機する時間（秒）。-1は永久に待機することを表します。このパラメータは必須で、NULLは使用できません。

結果セット

ttRepSubscriberWaitは次の結果セットを返します。


列	データ型	説明
timeOut	BINARY(1)	0x00: 指定されたwaitTime内で待機は成功しました。指定されたサブスクライバは、このプロシージャがコールされた時点の書込みLSNと同期されています。十分な時間が割り当てられていない場合、TimesTenは0x01を返します。

例

定義済レプリケーション・スキームが1つある場合に、SERVER2上のサブスクライバREPが追いつくまで送信側データ・ストアを10分待機させるには、次のように実行します。

CALL ttRepSubscriberWait( , , `REP' , `SERVER2', 600 );

注意

このプロシージャは、TimesTen Data Manager ODBCアプリケーションでのみサポートされます。TimesTen ClientまたはJDBCアプリケーションではサポートされません。